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PLEASE REVIEW THE TERMS OF THE FOUNDATION API LICENSE VERSION 1.0 
BEFORE READING THIS DOCUMENT. 


You may view the Foundation API License v1.0 at: 


http: //www.limofoundation.org/images/stories/pdf/limo_foundation_api_license_v1-0.pdf 


This is an agreement between you (“You”) and LiMo Foundation related to the use of the APIs contained 
within this document. By accessing, downloading, reading or otherwise using the APIs contained within 
this document, You accept the terms of the Foundation API License v1.0. If You do not agree to the terms 
of this agreement, do not download, read and/or otherwise use any of the APIs. 


If You are agreeing to be bound by the Foundation API License v1.0 on behalf of your employer, You 
represent and warrant that you have full legal authority to bind your employer to this agreement. If You 
do not have the requisite authority, You may not download, read and/or otherwise use any of the APIs on 
behalf of your employer. 


© Copyright LiMo Foundation and others 2007, 2008. All rights reserved. 


NOTICES 


This document and the technical information it contains is subject to change by LiMo Foundation and its 
members at any time without notice as authorized by LiMo Foundation bylaws and other documents gov- 
erning LiMo Foundation, including amendments thereto. All statements regarding LiMo’s future direction 
or intent are subject to change or withdrawal without notice, and represent goals and objectives only. 


Any reference in this document to non-LiMo Foundation Web sites do not in any manner serve as an en- 
dorsement of those Web sites. The materials at those Web sites are not part of this document or any product 
described in this document and use of those Web sites is at your own risk. 


Information concerning non-LiMo products was obtained from the suppliers of those products or a public 
announcement or source. LiMo cannot confirm the accuracy of that information or the performance, com- 
patibility or any other claims related to non-LiMo products. 


All names or other identifying information used in examples in this document are fictitious. and any similar- 
ity to the names or other identifying information of an actual person or organization is entirely coincidental. 


THIS DOCUMENT AND ALL INFORMATION IN THIS DOCUMENT ARE PROVIDED “AS IS”, 
WITHOUT ANY EXPRESS OR IMPLIED WARRANTY OR CONDITION, INCLUDING, BUT NOT 
LIMITED TO, ANY WARRANTY OR CONDITION OF ACCURACY OR COMPLETENESS, MER- 
CHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR AGAINST INFRINGEMENT. ALL 
EXPRESS AND IMPLIED STATUTORY WARRANTIES ARE DISCLAIMED, INCLUDING WITH- 
OUT LIMITATION, THE WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR 
PURPOSE, TITLE OR NON-INFRINGEMENT. 


This document includes modified portions of the documentation from the D-Bus software package li- 
censed under the Academic Free License version 2.1, which license is found at http://dbus. 
freedesktop.org/doc/COPYING and to which assent is requested for the unmodified portions of 
the documentation from the D-Bus software package. 
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Chapter 1 


IPC using D-Bus 


1.1 References 


[1] Software Architecture Document, Version 1.1 Revision 1.4, LiMo Foundation, 11 September 2007 


1.2 Overview 


LiMo Foundation Platform Release 1 uses D-Bus from freedesktop.org for interprocess communication 
(IPC). Architecturally, D-Bus has the following layers: 


e A library, 1ibdbus, that allows two applications to connect to each other and exchange messages. 


e A message bus daemon executable, built on 1ibdbus, that multiple applications can connect to. 
The daemon can route messages from one application to zero or more other applications. 


e Wrapper libraries or bindings based on particular application frameworks. For example, 
libdbus-glib and 1ibdbus-qt. There are also bindings to languages such as Python. These 
wrapper libraries are the API most people should use, as they simplify the details of D-Bus pro- 
gramming. libdbus is intended to be a low-level backend for the higher level bindings. Much of the 
libdbus API is only useful for binding implementation. 


1.3 Industry Standard 


D-Bus 1.0.2 
http://www. freedesktop.org/wiki/Software/dbusthead-ed92e8f84ae0374ae3a2e3f714c2eb003” 


1.4 External API Documents 


http://dbus. freedesktop.org/doc/dbus-tutorial.html 
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1.5 Plug-in Extension Point Interface 


None 


1.6 Other Interfaces 


None 


1.7 Other Notes 


The URL provided in Industry Standard links to D-Bus 1.0.2 documentation and download- 
able source code. Documentation for the most recent version of D-Bus may be found at 
http: //dbus.freedesktop.org/doc/api/html/index.html 


To generate Doxygen documentation for D-Bus version 1.0.2: 


« Download D-Bus 1.0.2 source code. 


e Download and Install Doxygen: See http: //www.stack.nl/=dimitri/doxygen/install.htmltinstal 
bin_windows 


e Run doxygen to generate the HTML files: See http: //os.cqu.edu.au/usr/share/doc/doxygen-1.4.7/1 
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Chapter 2 


File Index 


2.1 File List 


Here is a list of all documented files with brief descriptions: 


ComponentOverview.h (Component Programming Interface Overview Header Template for 
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Chapter 3 


File Documentation 


3.1 ComponentOverview.h File Reference 


3.1.1 Detailed Description 


Component Programming Interface Overview Header Template for Doxygen. 


This file contains configuration information for documentation generation; it does not contain any API- 
specific information. 


Index 


ComponentOverview.h, 5 


